v0.17.3

Compare Source

Changed

• Reverted SemVer-breaking DeviceBusy error variant addition.

Fixed

• ASIO: Fix linker errors.

v0.17.2

Compare Source

Added

• DeviceBusy error variant for retriable device access errors (EBUSY, EAGAIN).
• ALSA: Debug implementations for Host, Device, Stream, and internal types.
• ALSA: Example demonstrating ALSA error suppression during enumeration.
• ALSA: Support for native DSD playback.
• WASAPI: Enable as-necessary resampling in the WASAPI server process.

Changed

• Bump overall MSRV to 1.78.
• ALSA: Update alsa dependency to 0.11.
• ALSA: Bump MSRV to 1.82.
• CoreAudio: Update core-audio-rs dependency to 0.14.

Fixed

• ALSA: Enumerating input and output devices no longer interferes with each other.
• ALSA: Device handles are no longer exclusively held between operations.
• ALSA: Reduce Valgrind memory leak reports from ALSA global configuration cache.
• ALSA: Fix possible race condition on drop.
• ALSA: Fix audio callback stalling when start threshold is not met.

v0.17.1

Compare Source

Added

• ALSA: Default implementation for Device (returns the ALSA "default" device).
• CI: Checks default/no-default/all feature sets with platform-dependent MSRV for JACK.

Changed

• ALSA: Devices now report direction from hint metadata and physical hardware probing.

Fixed

• ALSA: Device enumeration now includes both hints and physical cards.
• JACK: No longer builds on iOS.
• WASM: WasmBindgen no longer crashes (regression from 0.17.0).

v0.17.0

Compare Source

Added

• DeviceTrait::id method that returns a stable audio device ID.
• HostTrait::device_by_id to select a device by its stable ID.
• Display and FromStr implementations for HostId.
• Support for custom Hosts, Devices, and Streams.
• Sample::bits_per_sample method.
• Copy implementation to InputCallbackInfo and OutputCallbackInfo.
• StreamError::StreamInvalidated variant for when stream must be rebuilt.
• StreamError::BufferUnderrun variant for buffer underrun/overrun notifications.
• Hash implementation to Device for all backends.
• AAudio: Send and Sync implementations to Stream.
• AAudio: Support for 12 and 24 kHz sample rates.
• ALSA: I24 and U24 sample format support (24-bit samples stored in 4 bytes).
• ALSA: Support for 12, 24, 352.8, 384, 705.6, and 768 kHz sample rates.
• ALSA: Eq and PartialEq implementations to Device.
• CI: Native ARM64 Linux support in GitHub Actions.
• CoreAudio: i8, i32 and I24 sample format support (24-bit samples stored in 4 bytes).
• CoreAudio: Support for loopback recording (recording system audio output) on macOS > 14.6.
• CoreAudio: Send implementation to Stream.
• Emscripten: BufferSize::Fixed validation against supported range.
• iOS: Complete AVAudioSession integration for device enumeration and buffer size control.
• JACK: Support for macOS and Windows platforms.
• JACK: BufferSize::Fixed validation to reject requests that don't match server buffer size.
• WASAPI: Expose IMMDevice from WASAPI host Device.
• WASAPI: I24 and U24 sample format support (24-bit samples stored in 4 bytes).
• WASAPI: Send and Sync implementations to Stream.
• WebAudio: Send and Sync implementations to Stream.
• WebAudio: BufferSize::Fixed validation against supported range.

Changed

• MSRV depends on the platform and at minimum 1.77.
• Set examples to Rust 2021.
• SampleRate from struct to u32 type alias.
• Update audio_thread_priority to 0.34.
• Migrate CHANGELOG to Keep a Changelog format.
• AAudio: Configure buffer to ensure consistent callback buffer sizes.
• AAudio: Buffer size range detection to query the AudioService property correctly.
• ALSA: Improve BufferSize::Fixed precision and audio callback performance.
• ALSA: BufferSize::Default to use the device defaults.
• ALSA: Card enumeration to work like aplay -L does.
• ALSA: Update alsa to 0.10.
• ALSA: Pass silent=true to PCM.try_recover, so it doesn't write to stderr.
• ALSA: Report buffer underruns/overruns via StreamError::BufferUnderrun.
• ASIO: Share sys::Asio instance across all Host instances.
• CI: Fix cargo publish to trigger on GitHub releases instead of every master commit.
• CI: Replace cargo install commands with cached tool installation for faster builds.
• CI: Update actions to latest versions (checkout@​v5, rust-cache@​v2).
• CI: Verify compatibility with windows crates since v0.59.
• CI: Test platforms on appropriate MSRV per backend.
• CI: Fix cargo update syntax for compatibility with Cargo 1.70 (use -p flag instead of positional argument).
• CoreAudio: Device::supported_configs to return a single element containing the available sample rate range when all elements have the same mMinimum and mMaximum values.
• CoreAudio: Default audio device detection to be lazy when building a stream, instead of during device enumeration.
• CoreAudio: Configure device buffer to ensure predictable callback buffer sizes.
• CoreAudio: Remove Clone implementation from Stream.
• JACK: Use StreamError::StreamInvalidated for JACK server sample rate changes.
• JACK: Report buffer underruns/overruns via StreamError::BufferUnderrun.
• WASAPI: Update windows to >= 0.59, <= 0.62.

Fixed

• ALSA: Format selection to probe hardware endianness instead of assuming native byte order.
• ALSA: Data race in stream shutdown.
• ASIO: Handling for kAsioResetRequest message to prevent driver UI becoming unresponsive.
• ASIO: Buffer silencing logic to work with non-conformant drivers (e.g., FL Studio ASIO).
• CoreAudio: Timestamp accuracy.
• CoreAudio: Segfaults when enumerating devices.
• CoreAudio: Undefined behavior related to null pointers and aligned reads.
• CoreAudio: Unnecessary microphone permission requests when using output devices only.
• iOS: Example by properly activating audio session.

Removed

• WebAudio: Optional wee-alloc feature for security reasons.

v0.16.0

Compare Source

Added

• Optional supports_input/output methods to DeviceTrait.
• 384000Hz to COMMON_SAMPLE_RATES.
• Constructors for InputCallbackInfo, OutputCallbackInfo and StreamInstant.
• Default impl for Host.
• PartialOrd, Ord and Hash implementations for SampleFormat.
• Clone, PartialEq, Eq and Hash implementations for all error enums.
• ASIO: Support for int24.

Changed

• AAudio: Migrate from oboe to ndk::audio. NOTE: This raises the minimum Android API version to 26 (Android 8/Oreo).
• AAudio: Improve device names.
• ALSA: Set realtime priority for stream threads.
• ALSA: Improved card enumeration.
• CoreAudio: Update coreaudio-rs dependency to 0.13.
• JACK: Update jack dependency to 0.13.
• WASAPI: Set realtime priority for stream threads.

Fixed

• ALSA: Don't panic when handling invalid stream timestamps.
• ALSA: Fix infinite loop on broken pipes.
• ASIO: Fix build failure on Windows.
• CoreAudio: Fix callback being called after dropping the stream.
• CoreAudio: Fix non-default audio output.
• CoreAudio: Fix handling of integer input formats.
• WASAPI: Fixed memory leak.
• WASAPI: Remove usage of eval.

v0.15.3

Compare Source

Added

• try_with_sample_rate, a non-panicking variant of with_sample_rate.
• #[must_use] attribute to struct platform::Stream.
• Copy implementation to enum SupportedBufferSize and struct SupportedStreamConfigRange.
• Clone implementation to platform::Device.

Changed

• AAudio: Update jni dependency to 0.21.
• AAudio: Update oboe dependency to 0.6.
• AAudio: Update ndk dependency to 0.8 and disable default-features.
• ALSA: Update alsa dependency to 0.9.
• CI: Update actions, use Android 30 API level in CI, remove asmjs-unknown-emscripten target.
• Examples: Migrate wasm example to trunk, improve syth-thones example.
• WASAPI: Update windows dependency to v0.54.
• WebAudio: Update wasm-bindgen to 0.2.89.

Fixed

• WebAudio: Crash on web/wasm when atomics flag is enabled.

Removed

• parking_lot dependency in favor of the std library.

v0.15.2

Compare Source

Added

• WebAudio: Support for multichannel output streams.

Changed

• WASAPI: Update windows dependency.

Fixed

• WASAPI: Fix some thread panics.

v0.15.1

Compare Source

Added

• AAudio: Feature oboe-shared-stdcxx to enable shared-stdcxx on oboe for Android support.

Changed

• CoreAudio: Switch mach dependency to mach2.

Removed

• thiserror dependency.

v0.15.0

Compare Source

Added

• CoreAudio: Disconnection detection on Mac OS.

Changed

• Switch to the dasp_sample crate for the sample trait.
• Adopt edition 2021.
• AAudio: Update oboe dependency.
• AAudio: Update alsa dependency.
• CoreAudio: Update coreaudio-sys dependency.
• Emscripten: Switch to web-sys on the emscripten target.
• JACK: Update jack dependency.
• WASAPI: Update windows-rs dependency.